home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d11 / sos104.arc / SOS.DOC < prev   
Text File  |  1988-05-04  |  11KB  |  274 lines
  1.        Save Our Screens (SoS) v1.04  (c) 1987, 1988  Gary J. Shapiro
  2.                           - All Rights Reserved -
  3.                               March 20, 1988
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  Save Our Screens (SoS) is distributed under the SHAREWARE concept.  It is
  11.  NOT Public Domain.  If you find SoS to be of value, a contribution of
  12.  $15.00 is suggested.  Send to:
  13.  
  14.  
  15.                        Gary J. Shapiro
  16.                        6 Scenic Court
  17.                        Marlboro NJ,  07746
  18.  
  19.  
  20.  Regardless if you pay or not, you are encouraged to make copies for others
  21.  to use as well as for distribution on Bulletin Boards (BBS).  However, you
  22.  are not authorized to accept any payment for doing so.
  23.  
  24.  
  25.  Suggestions?  Problems?  Bugs?  Please let me know.  Your help will only
  26.  help to improve SoS.
  27.  
  28.  
  29.  
  30.  
  31.  DISCLAIMER
  32.  ----------
  33.  
  34.  You are completely responsible for determining the fitness or usability of
  35.  this package.  I will not be liable for any damages, of any kind, arising
  36.  from any failure of any programs in this package to perform as expected.
  37.        Save Our Screens (SoS) v1.04  (c) 1987, 1988  Gary J. Shapiro
  38.  
  39.  
  40.  
  41.  INTRODUCTION
  42.  ------------
  43.  
  44.  SoS is a Terminate and Stay Resident (TSR) program that allows you to
  45.  capture and restore up to 8 text screen images to memory or disk.  This
  46.  process can be done within most applications.  MDA, CGA, EGA, MCGA and VGA
  47.  text modes are fully supported in 40 and 80 column modes.
  48.  
  49.  All SoS instructions and information is presented via POP-UP windows
  50.  activated by a series of HOTKEYS.
  51.  
  52.  
  53.  SYSTEM REQUIREMENTS
  54.  -------------------
  55.  
  56.  SoS requires an IBM PC/XT/AT/PS2 or true compatible that have their
  57.  display buffers at 0b000h and 0b800h.  DOS 2.0 or later is also required.
  58.  
  59.  SoS with a maximum of 1 screen image will require approximately 11k.  Each
  60.  additional screen will add 4k to this number.  The maximum total memory
  61.  required is 38k with 8 screen images requested.
  62.  
  63.  
  64.  INVOKING SoS
  65.  ------------
  66.  
  67.  SoS is invoked at the DOS command line or in a batch file as follows:
  68.  
  69.   A>SOS <Optional Parameters>
  70.  
  71.     Optional Parameters are:
  72.  
  73.  
  74.       /Sn (n=1 to 8)  Maximum allowable number of screens to save/restore.
  75.                       S3 is default.
  76.       /Rn (n=0 or 1)  Enable(1) or Disable(0) CGA snow detection.
  77.                       R1 is default.
  78.  
  79.  
  80.  If no parameters are specified the default is to allow a maximum of 3
  81.  screens and CGA snow detection is enabled, ie. /S3 /R1.
  82.  
  83.  The '/' must precede the parameter and at least one space must come
  84.  between successive parameters.  The order of parameters is not important.
  85.  
  86.  If you're using a display adapter that does not produce 'snow', you should
  87.  specify R0.  All IBM CGA users should specify R1 or take the default. For
  88.  all other adapters there is no need to specify this parameter.  Sos
  89.  automatically assumes /R0 since these adapters do not produce 'snow'.
  90.  
  91.  SoS will inform you of parameter errors and will not let a second copy be
  92.  loaded into memory.  If enough memory isn't available to load SoS, a
  93.  message will be displayed.  In this case, you should decrease the number
  94.  of screens requested by 1 until SoS successfully loads.  If it still won't
  95.  load with 1 screen, you need additional memory on your system.  If SoS
  96.  fails to load, ERRORLEVEL will be set to 1.
  97.        Save Our Screens (SoS) v1.04  (c) 1987, 1988  Gary J. Shapiro
  98.  
  99.  
  100.  
  101.  If you are using other TSR programs and SoS fails to function properly or
  102.  system problems are experienced try changing the loading order of your
  103.  programs.  While SoS was designed to 'behave well' some 'not so nice'
  104.  TSR's might cause problems.  If SoS is loaded first there should be no
  105.  problems.  If you are using SIDEKICK or a similar product, please load SoS
  106.  before them to insure the highest degree of reliability.
  107.        Save Our Screens (SoS) v1.04  (c) 1987, 1988  Gary J. Shapiro
  108.  
  109.  
  110.  
  111.  ACTIVATING SoS
  112.  --------------
  113.  
  114.  SoS is 'activated' in the following manner:
  115.  
  116.  
  117.  Save to Memory
  118.  --------------
  119.  Press the Ctrl-LeftShift-S keys simultaneously.  At this point, a message
  120.  will appear while SoS is waiting for you to enter a number from 1 to the
  121.  maximum number of screens you specified when SoS was invoked (or 3 if the
  122.  default was taken).  Entering a valid number will cause SoS to save the
  123.  screen image to memory under that number then return you to where you
  124.  were.  SoS messages that appear will NOT be saved.  Only the original
  125.  screen will be.  If you press an invalid key or a number out of range, an
  126.  SoS message will be displayed.  At this point you can enter a valid number
  127.  or press ESC to return to where you were.  A successful save will be be
  128.  indicated by another SoS message.
  129.  
  130.  Any existing memory images with the same screen number will be overlayed.
  131.  
  132.  
  133.  Save to Disk
  134.  ------------
  135.  Press the Alt-LeftShift-S keys simultaneously.  The same actions should
  136.  be followed as Saving to Memory.  In this case though, the image saved is
  137.  written to a file in the current directory.  The file name appears as
  138.  SOS.00n, where n is the number the screen was saved under.
  139.  
  140.  Any existing disk images with the same screen number will be overlayed.
  141.  
  142.  
  143.  Restore from Memory
  144.  -------------------
  145.  Press the Ctrl-LeftShift-R keys simultaneously.  At this point, a message
  146.  will appear while SoS is waiting for to enter a number from 1 to the
  147.  maximum number of screens you specified when SoS was invoked (or 3 if the
  148.  default was taken).  Entering a valid number will cause SoS to restore
  149.  that screen image number from memory.  If you press an invalid key or a
  150.  number out of range, an SoS message will be displayed.  At this point you
  151.  can enter a valid number or press ESC to return to where you were.  A
  152.  successful save will be indicated by another SoS message.
  153.  
  154.  If a valid number is specified, the saved screen image will appear.  At
  155.  this point you can enter any other screen number and that screen image
  156.  will appear.  In affect, you can cycle through all your saved screen
  157.  images.  To exit from this mode press the ESC key.  This will return you
  158.  to where you were prior to activating SoS.
  159.  
  160.  Entering a valid screen number, but one that has not been previously saved
  161.  to, will result in an SoS message indicating so.
  162.  
  163.  You can also cycle through your saved screens by pressing the SPACE BAR.
  164.  The cycling will start at screen #1 if SoS has just been activated, or at
  165.  the next screen if a screen is already being displayed.  Cycling and
  166.  screen selection by number can be intermixed.
  167.        Save Our Screens (SoS) v1.04  (c) 1987, 1988  Gary J. Shapiro
  168.  
  169.  
  170.  
  171.  Restore from Disk
  172.  -----------------
  173.  Press the Alt-LeftShift-R keys simultaneously.  The same actions should
  174.  be followed as Restoring from Memory.  In this case though, the saved
  175.  images are read from the corresponding SOS.00n file on the current
  176.  directory.
  177.  
  178.  The image restored will overlay the corresponding screen image in memory
  179.  with the same number, or create a new one if none is present.  If you
  180.  cycle through all your disk screen images, all the memory images will be
  181.  overlayed.  Please be aware of this aspect of SoS.  If you desire only to
  182.  restore 1 disk screen image, make sure to press ESC after viewing it.
  183.  
  184.  
  185.  SCREEN INFORMATION
  186.  ------------------
  187.  
  188.  When doing a screen restore from memory or disk, you sometimes can't
  189.  remember which screen number you are currently displaying.  This is
  190.  especially true if you are cycling through many screens.
  191.  
  192.  To determine which screen number is currently being displayed, enter a '?'
  193.  when in RESTORE mode.  The screen number you are currently viewing will
  194.  then appear.  From here you can continue restoring other screens or return
  195.  to the current screen by entering the DISPLAYED screen number.  At least
  196.  one screen has to be restored first, otherwise the request will be
  197.  ignored.
  198.  
  199.  In SAVE mode this function is meaningless and the `?` is treated as an
  200.  invalid key.
  201.        Save Our Screens (SoS) v1.04  (c) 1987, 1988  Gary J. Shapiro
  202.  
  203.  
  204.  
  205.  ERRORS
  206.  ------
  207.  
  208.  Any errors that are encountered during SoS processing will be indicated by
  209.  an error message.  In most cases you are instructed to correct the problem
  210.  then retry the operation.  Entering ESC will immediately exit you from SoS
  211.  back to where you were.
  212.  
  213.  
  214.  MISCELLANEOUS
  215.  -------------
  216.  
  217.  Saves and restores from/to a graphics mode are not supported.  If you try
  218.  to activate SoS in a graphics mode, SoS will ignore the request.
  219.  
  220.  If a screen in 40 column mode is saved and is later recalled in 80 column
  221.  mode you might see 'garbage' in the bottom half of the screen.  SoS always
  222.  restores the amount of data to fit the current screen size.  Restoring an
  223.  80 column image to a 40 column screen will result in the loss of data.
  224.  This applies also to EGA 43 line mode and VGA 50 line mode.
  225.  
  226.  All pages are supported within SoS.  SoS will always restore to the
  227.  current page, not the one in which the screen image was saved.
  228.  
  229.  EGA 43 and VGA 50 line mode is not supported fully at this time.  SoS will
  230.  work in this mode, but since the maximum screen size supported is 80x25,
  231.  some data will be lost.
  232.  
  233.  Once a screen image is saved you can save any number of other screens
  234.  under that same screen number.  Just keep in mind that the last one saved
  235.  is what you will see when doing a restore function.
  236.  
  237.  Disk screen images can be saved and used between sessions.  They are not
  238.  tied to the session which created them.  Memory screen images on the
  239.  otherhand cease to exist when the machine is turned off.
  240.  
  241.  The SOS.00n files can be deleted when not needed.  Each 80x25 screen image
  242.  file is 4000 bytes in length.  Each 40x25 screen image file is 2000 bytes
  243.  in length.
  244.        Save Our Screens (SoS) v1.04  (c) 1987, 1988  Gary J. Shapiro
  245.  
  246.  
  247.  
  248.  HISTORY OF CHANGES
  249.  ------------------
  250.  
  251.  V1.01,  July 07, 1987  -  First official release of Save Our Screens (SoS).
  252.  
  253.  V1.02,  July 13, 1987  -  Fixed a minor problem with the critical error
  254.                            handling routine during a disk restore.
  255.                         -  Added restore screen cycling via the SPACE BAR.
  256.  
  257.  V1.03, March 03, 1988  -  Internal memory improvements.
  258.                         -  Added support for MCGA and VGA display adapters.
  259.                         -  Added PS/2 support.
  260.                         -  Added ability to remove SoS from memory.
  261.                         -  Added ERRORLEVEL setting for load failures.
  262.  
  263.  V1.04, March 20, 1988  -  Eliminated the ability to remove SoS.  (Suggest
  264.                              that one of the many TSR managers be used for
  265.                              this if required.)
  266.                         -  Added memory utilization statistics at load time.
  267.                         -  Added screen information via the '?' key while
  268.                            doing restores.
  269.                         -  Internal improvements to make SoS more
  270.                            compatable with other TSR's.
  271.                         -  Cosmetic changes to the SoS pop-up windows.
  272.  
  273.  
  274.